Inside Macintosh: 3D Graphics Programming With QuickDraw 3D /

Chapter 10 - Group Objects / Group Objects Reference

Group Objects Routines / Getting Object Positions

Q3Group_GetPreviousObjectPosition

You can use the Q3Group_GetPreviousObjectPosition function to get the position of the previous instance of an object in a group.

TQ3Status Q3Group_GetPreviousObjectPosition (
TQ3GroupObject group, 
TQ3Object object, 
TQ3GroupPosition *position);

group

A group.

object

An object.

position

On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the previous instance of the specified object.

DESCRIPTION

The Q3Group_GetPreviousObjectPosition function returns, in the position parameter, the position of the previous instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the first instance of that object in the group, Q3Group_GetPreviousObjectPosition returns the value NULL in the position parameter.

ERRORS

kQ3ErrorInvalidObject
kQ3ErrorInvalidPositionForGroup
kQ3ErrorNULLParameter